<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<HTML>
<HEAD>
   <TITLE>int pblKfInsert</TITLE>
   <META NAME="GENERATOR" CONTENT="DOC++ 3.4.9">
</HEAD>
 <center>
<H2>Program Base Library Functions</H2>
</center>

<H2>int <A HREF="#DOC.DOCU">pblKfInsert</A></H2><H2>( <!1><A HREF="pblKeyFile_t.html">pblKeyFile_t</A>*  k,   unsigned char*  key,<BR>&nbsp;  int keylen,   unsigned char*  data,<BR>&nbsp;  long datalen )</H2><BLOCKQUOTE> insert a new record with the given key and data into a key file,</BLOCKQUOTE>

<A NAME="DOC.DOCU"></A>
<HR>
<H2>Documentation</H2>
<BLOCKQUOTE>
insert a new record with the given key and data into a key file,

<P>multiple records with the same key are allowed,
if there are already records with the same key the new
record will be inserted behind all records with the same key,

<P>the current record of the file will be set to the new record

<P><P>
<B>RESTRICTIONS</B>:
<BR> - the file must be open for update,
<BR> - key must point to the key to be inserted,
<BR> - keylen must be bigger than 0 and smaller than 256,
<BR> - data must point to the data be inserted,
<BR> - datalen must not be negative,
<BR> - if datalen == 0, the pointer data is not evaluated at all

<P></BLOCKQUOTE>
<DL><DT><DT><B>Parameters:</B><DD><B>k</B> -   key file to insert to                             
<BR><B>key</B> -   key to insert                                     
<BR><B>keylen</B> -   length of the key                                 
<BR><B>data</B> -   data to insert                                    
<BR><B>datalen</B> -   length of the data                                <BR><DT><B>Returns:</B><DD>  int rc == 0: call went ok
<BR>  int rc != 0: some error occured, see pbl_errno
<BR><DD></DL><P><P><I><A HREF="index.html">Alphabetic index</A></I></P><HR>
<BR>
This page was generated with the help of <A HREF="http://docpp.sourceforge.net">DOC++</A>.
</BODY>
</HTML>
